 README.TXT    32-bit Windows Environment Check Utility    Release 2.1
============  ==========================================  =============

This README.TXT file contains information about the 32-bit Windows
environment utility.


Contents:
==========
1. About CHKWIN32.EXE
2. Files
3. Troubleshooting
4. Problem report form
5. Files used by Advantage clients
6. Operating system codes (DOS error numbers and descriptions)


1. About CHKWIN32.EXE
=====================

a) CHKWIN32.EXE is a diagnostic utility that tests the connection
   between a client workstation and the Advantage Database Server.
   CHKWIN32.EXE reports the user network information that will help
   troubleshoot problems that may occur when connecting to the
   Advantage Database Server.

b) CHKWIN32.EXE uses a version of AXCWS32.DLL for communication to
   the Advantage Database Server. This utility will first try
   to communicate to the Advantage Database Server using IPX. If
   either client or server do not have IPX then this utility will
   try to use IP.

c) CHKWIN32.EXE reports drive mappings, drive types, network
   settings, Advantage DLLs (32-bit and 16-bit), non-Advantage
   DLLs (which are used by Advantage clients), etc.

d) This utility will try to connect to the Advantage Database Server.
   It will report the server name and name of the semaphore connection
   file that is used for the connection status to the server.

e) All information utilities write information to ENV_LOG.TXT that
   will be created in the same directory as this utility. Make sure
   you have this file on hand if you need to contact Advantage
   Technical Support.


2. Files
========

a) CHKWIN32.EXE -- The executable that checks communication to the
                   Advantage Database Server and reports environment
                   information.

b) README.TXT   -- This file.

c) ENV_LOG.TXT  -- Output file containing the environment information.
                   It is created when WIN16ENV.EXE or WIN32ENV.EXE are
                   executed. This file is created in the same directory
                   as the executable.

d) REPORT.TXT   -- This file is used for feedback on this utility. If
                   comments or additional functionality is needed,
                   please use this form.

e) ENVIPX32.DLL -- The communication DLL. This file must be in the same
                   directory as CHKWIN32.EXE.


3. Troubleshooting
==================

This utility may refer you to one of these sections under certain error
conditions. You should also look up the error code that was returned
in ADSERROR.HLP for further help.

   **********************
a) "Find Advantage Error"
   **********************

   Advantage Database Server for NetWare
   -------------------------------------
   I) Make sure Advantage Database Server is loaded and running on
      the NetWare server you are using.

   II) Make sure you are attached to the file server. Map a drive to
       the file server. You only need to be attached to the server but
       mapping a drive forces you to be attached.

   III) Make sure you are not logged into more than 8 NetWare servers.
        The Advantage Database Server must be on one of the first eight
        NetWare servers in which you are logged in.


   Advantage Database Server for Windows NT/2000
   ---------------------------------------------
   IV) Make sure the Advantage Database Server Service is started on
       the Windows NT/2000 server you are using.

   V) The client and server have different IPX frame types. Check the
      frame types on the client and server. If they are different
      or it is set to AUTO then specify the settings to be the same
      type. Set them to both to 802.2 or both to 802.3.

      If you can "see" files on the Windows NT/2000 server, the client
      and server may be communicating through another protocol, not
      IPX. You can test your IPX communication to the server by
      removing all protocols but IPX and NetBIOS and rebooting your
      machine. If you can see the server, IPX communication to the
      server is working; if you cannot see the server, make sure the
      IPX frame types are the same on the client machine and the
      NT/2000 Server. Also make sure you have enabled NetBIOS.

   VI) NetBIOS needs to be enabled. NetBIOS is used in discovering
       the Advantage Database Server. On Windows 95/98 machines select
       "enable NetBIOS over IPX/SPX" in the "IPX/SPX-compatible
       Protocol" properties or add the TCP/IP protocol. Adding the
       TCP/IP protocol also adds NetBIOS. On Windows NT/2000 machines,
       add the NetBIOS protocol.

   VII) The client disk drive cannot be a substituted drive. A
        substituted drive is an alias for a drive. It is usually in
        the autoexec.bat file. Example, SUBST Z: C:\TEMP. This is not
        supported.

   VIII) Problem Description:
         When using NTFS with Windows NT/2000, it is possible to
         receive 6610, 9029 and/or 7013 errors either in the Advantage
         error log or from the application on the client PC. The 6610
         and 7013 errors will be reported by the application. The 9029
         and 7013 errors will be reported in the Advantage error log,
         ADS_ERR.DBF, along with a corresponding Windows NT/2000 error
         5 (access denied) error.

         Solution:
         There are two possible solutions to this issue. The
         recommended solution is to add to the permissions and security
         attributes of  the configured semaphore connection file path
         share as well as any share where Advantage will access data
         files so that the SYSTEM group has FULL CONTROL access to
         those shares. This will provide access for all services,
         including the Advantage Database Server Service for Windows
         NT/2000, to all the files in the share.

         An alternative method for resolving this issue is to create a
         new user from within User Manager for Domains. This user can
         be given any name. Make sure that this new user account has
         FULL CONTROL access to the configured semaphore connection
         file path share as well as any share where Advantage will
         access data files. Then change the Advantage Database Server
         Service startup properties (from within the Service Control
         Manager) so that the Advantage Database Server Service will
         log on as this new user's account.

         Notes:
         To determine if a physical hard drive is formatted with NTFS,
         run the Windows NT/2000 Disk Administrator. The physical hard
         drive will state its formatting structure directly above the
         available storage space.

   ************************
b) "Get Local Target Error"
   ************************

   I) This is a Disjoint Network error. A Disjoint Network
      is a network where the protocol is not present throughout
      the network. The client and server have IPX on their segments but
      the wire that connects the segments together does not have IPX.
      There are three ways to fix this problem:
      a) Put the client and server on the same segment or on segments
         that can communicate through IPX.

      b) For applications that can use IP, remove the IPX protocol
         from the client or the server. This will force the client and
         server to use IP.

      c) Put IPX on the connecting network.

   *********
c) AIS ERROR
   *********

   This environment utility does not support the Advantage Internet
   Server (AIS). If an error message is returned that mentions
   problems with AIS, you need to edit your C:\WINDOWS\AIS.INI file
   and change the setting "COM_TYPE=AIS" to "COM_TYPE=Remote".
   By changing this setting, this client will then try to connect
   to an Advantage Database Server and not to a Advantage Internet
   Server.


4. Problem Report Form
=======================

Supplied with this utility is a form for reporting problems you may
encounter, REPORT.TXT. This is an ASCII text file that you can print
out and fill out by hand or make a duplicate of and fill out within
an editor. Use that form whenever you encounter a problem. This will
help Advantage Technical Support resolve your issue as soon as
possible.


5. Files used by Advantage Window clients.
==========================================

a) CHKWIN32.EXE checks for the existence of these files in your
   search path. The location, version (for Advantage files), and
   existence of these files in your search path are reported to
   ENV_LOG.TXT. See the README.TXT and/or FILES.TXT for each
   client product that you are using to see which files each
   Advantage window client needs.

              **************************
              Advantage File Information
              **************************

                  16-BIT ADVANTAGE CLIENT ENGINE FILES
   "ACE16.DLL"
                  16-BIT COMMUNICATION FILES
   "AXCOMM16.DLL"
   "AXCUS16.DLL"
   "ADSIP16.DLL"
   "ADSIPX16.DLL"
                  32-BIT ADVANTAGE CLIENT ENGINE FILES
   "ACE32.DLL"
                  32-BIT COMMUNICATION FILES
   "AXCWS32.DLL"
   "AXCUS32.DLL"
                         LOCAL SERVER FILES
   "ADSLOC32.DLL"
   "ADSLOC16.DLL"
   "ADSLOCAL.CFG"
   "EXTEND.CHR"
   "ANSI.CHR"
                             ODBC FILES
   "AXSODBC.DLL"
   "AXSSETUP.DLL"
   "SIMSPY.DLL"
   "AXODBC32.DLL"
   "AXSET32.DLL"
   "SIMSPY32.DLL"
   "CTL3D32.DLL"
                             VO FILES
   "AXDBFCDX.RDD"
   "AXDBFNTX.RDD"
                 Non-Advantage Files that are used.
   "NWCALLS.DLL"
   "NWIPXSPX.DLL"
   "NETAPI.DLL"
   "NETWARE.DRV"
   "WINSOCK.DLL" <File Version> <File Date> <File Size>
   "WSOCK32.DLL" <File Version> <File Date>
